home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / misc / exa.lha / Exa / Exa.doc < prev    next >
Encoding:
Text File  |  1994-06-02  |  6.7 KB  |  149 lines
  1.  
  2.  
  3.  
  4.                                   Exa 0.1
  5.                            © 1994 David Gaussinel
  6.                                   Cardware
  7.  
  8.  
  9.  
  10. Avant-Propos
  11.  
  12.    Le but d'Exa est de permettre d'exploiter depuis n'importe quel programme
  13. la formidable library qu'est la WhatIs.library. J'ai vu certains  programmes
  14. qui  l'utilisaient  mais aucun ne m'ayant plus j'ai décidé de créer moi-même
  15. un programme comme je révais. Mais si vous connaissez mes autres  programmes
  16. vous  saurez  que  je  programme  généralement  en  Amos.  C'était  bien sur
  17. impensable de programmer un logicel comme Exa en  Amos,  aussi  je  me  suis
  18. penché sur le E. C'est lui qui m'a permis de réaliser ce dont je révais.
  19.  
  20. Objet
  21.  
  22.    Exa reconnait le type d'un fichier, grace à la whatis.library, et  permet
  23. à  l'utilisateur  d'opérer  dessus des actions qu'il aura lui même prévu. Un
  24. simple exemple. Vous soumettez à Exa un fichier  qu'il  reconnait  comme  un
  25. texte  Ascii.  Il  ouvre  alors  un  requester  vous  offrant le choix entre
  26. plusieurs actions que vous mêmes avez définies. Il peut par exemple y  avoir
  27. les actions Lire, Editer, Imprimer ... pour un texte Ascii.
  28.  
  29. Légal
  30.  
  31.    Exa est distribué TEL QUEL. En aucun cas l'auteur ne pourrait  être  tenu
  32. responsable  de toute détéroriation de quelque nature qu'elle soit causé par
  33. Exa. Vous utilisez ce logiciel à vos propres risques en  toute  connaissance
  34. de cause. Cependant je vois mal quelles détériorations Exa pourraient causer
  35. :)
  36.    Exa 0.1 est © 1994 David Gaussinel. L'utilisation et la diffusion  de  ce
  37. programme sont libres. Vous pouvez le copier, le manger ... mais en revanche
  38. il est formellement interdit de le vendre. Cette interdiction ne couvre bien
  39. sur  pas les couts occasionnés par la diffusion. En clair, et sans décodeur,
  40. il n'est pas permis de le diffuser sur des disquettes vendues à plus  de  25
  41. FF.  En  France,  certains  dépassent pourtant ce tarif largement... C'est à
  42. vous utilisateur du DP de vous prendre en main et de comparer les prix.
  43.    Exa est cardware c'est-à-dire que si vous  appréciez  et/ou  utilisez  le
  44. programme  vous  devez  envoyer  une  carte  postale  à l'auteur pour le lui
  45. signaler et ainsi lui faire comprendre que des améliorations et des  futures
  46. versions sont les bienvenues. Mon adresse est la suivante :
  47.               David Gaussinel - 18 rue Fénelon - 24200 Sarlat
  48.    ReqTools.library © Nico François
  49.    WhatIs.library © Sylvain Rougier et Pierre Carette.
  50.    
  51. Fred Fish a l'autorisation de l'inclure dans sa collection, ainsi que Pascal
  52. Rullier dans la collection BUGSSDP.
  53.  
  54. Matériel nécessaire
  55.  
  56.    Exa ne marchera que sur les systèmes 2.0  et  supérieur.  Les  librairies
  57. ReqTools et WhatIs doivent de plus être présentes en LIBS:.
  58.  
  59. Usage
  60.  
  61.    Exa est une commande Shell, autrement dit  pas  la  peine  de  la  lancer
  62. depuis   le  Workbench.  Vous  n'obtiendrez  qu'un  requester  vous  donnant
  63. l'identité du programme.
  64.    Depuis le Shell, vous pouvez faire : Exa ? pour obtenir  la  syntaxe  des
  65. options comme avec toute commande Shell classique.
  66.    Voici les options : NAME/A/M,CFG=CONFIG/K,PUBSCREEN/K,NOREQ/S,NOCFG/S
  67.    En premier lieu vous devez donc spécifier le nom du ou des  fichier(s)  à
  68. examiner.  CFG  sert  à définir le nom du fichier de configuration pour Exa.
  69. Par défaut ce fichier sera ENV:Exa.prefs. PUBSCREEN spécifie un écran public
  70. sur lequel viendront s'ouvrir les requesters. Si vous  indiquez  NOREQ  cela
  71. signifie  justement  que  vous  ne  voulez pas de requester, alors que NOCFG
  72. signifie que vous ne voulez pas qu'Exa charge un fichier de configuration.
  73.  
  74. Fichier de configuration
  75.  
  76.    Parlons un peu de ce fichier de configuration qui est le pivot central
  77. d'Exa. Pour chaque type que reconnait la WhatIs, il a le format suivant :
  78.  
  79. TYPE Text
  80.    GAD _Lis|_Imprime
  81.    Bin:MuchMore %f
  82.    Type >PRT: %f
  83. ENDTYPE
  84.  
  85.    Nous avons ici définit les actions pour le type Text. Il y aura ici  deux
  86. actions  qui  sont  Lis  et Imprime. Après l'indicateur GAD on trouve sur la
  87. même ligne le texte qui figurera dans les gadgets. Le  signe  _  indique  un
  88. raccourci clavier tandis que | sépare les gadgets entre eux.
  89.    Ensuite sur chaque ligne qui suit, on définit dans l'ordre  la  ligne  de
  90. commandes à exécuter où %f représente le nom du fichier sélectionné.
  91.    Mais il peut arriver aussi dans certains  cas  que  vous  souhaitiez  que
  92. plusieurs  types  aient le même type d'actions. Dans ce cas vous pouvez n'en
  93. définir qu'un et indiquez que les autres ont les mêmes actions que celui-ci.
  94. Dans notre exemple, nous pourrions écrire :
  95.  
  96. TYPE Doc
  97.    IDEM Text
  98. ENDTYPE
  99.  
  100.    pour que le type Doc ou le type Text qui en  réalité  ne  sont  pas  très
  101. éloignés aient le même type d'actions.
  102.       Enfin,  vous  pouvez  vouloir  qu'aucun  requester  ne   s'ouvre    et
  103. qu'immédiatement  une  action sur le fichier se produise. Imaginons que vous
  104. vouliez que n'importe quelle image soit immédiatement visionnée. Vous pouvez
  105. écrire :
  106.  
  107. TYPE ILBM
  108.    NOREQ
  109.    Bin:Mostra %f
  110. ENDTYPE
  111.  
  112.    Dernière précision mais oh combien utile, vous  pouvez  mettre  plusieurs
  113. commandes  sur  une  même  ligne d'instructions en les séparant par un trait
  114. vertical | comme pour les gadgets. Les  commandes  s'exécuteront  alors  les
  115. unes après les autres. Par exemple, vous pouvez faire :
  116.  
  117. TYPE LHArc
  118.    GAD _Liste
  119.    Bin:Lha v >T:temp|bin:MM T:temp|delete T:temp
  120. ENDTYPE
  121.  
  122.    Ceci vous permettra alors de lister le contenu des archives Lha et de les
  123. lire grace à MuchMore.
  124.  
  125. Utilisations pratiques
  126.  
  127.    Comme vous avez pu le remarquer Exa n'a  pas  d'interface  mais  tout  se
  128. passe  avec  le Shell. Cependant un bon moyen d'utiliser Exa est par exemple
  129. de l'utiliser avec ToolManager en créant un dock, une appicon ou un menu. De
  130. cette façon si par exemple vous avez créé  une  appicon  Exa,  vous  pourrez
  131. depuis  le  Workbench cliquer sur une icone et la lacher sur l'appicon d'Exa
  132. pour agir sur le fichier de l'icone. Vous pouvez  aussi  utiliser  Exa  avec
  133. n'importe  quel  gestionnaire  de  fichiers  comme BrowserII, DirectoryOpus,
  134. MegaD, etc... où vous définissez un menu ou un gadget pour Exa. De plus, Exa
  135. pouvant s'ouvrir sur un écran public, vous pourrez voir les  requesters  sur
  136. l'écran que vous voulez.
  137.  
  138. Remerciements
  139.  
  140.    A Sada pour avoir dessiné l'icone bien avant la fin du programme en  cinq
  141. minutes  un  jour  d'Aout.  Si  vous  voulez  utiliser  Exa  en AppIcon avec
  142. ToolManager vous pouvez utiliser cette icone.
  143.    Des remerciements tout particulier  vont  à  Sylvain  Rougier  et  Pierre
  144. Carrette pour avoir écrit la WhatIs.library qui est vraiment performante.
  145.    Je remercie aussi Nico François pour tout ses  programmes  DP  de  grande
  146. qualité et notament pour la ReqTools.
  147.    Enfin comment ne pas remercier l'auteur du E Wouter van Oortmerssen  pour
  148. son fabuleux langage.
  149.